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L.ID OS 

Ldos disk operating system (dos) is a easy to use DOS for the 
ZX-81 that features Hasic,Array and code saves ; and automatic 
management of the directory and disk file storage. 

Ldos resides on a 2K eprom that is memory mapped from address 
14236 to 16282. The controller also has on board a Zk ram buffer 
that is mapped from 12288 to 14225 . The dos is always entered 
by USR 143246 command . 

eg: to enter LDOS : 
type: PRINT USR 14336 


LDOS 
* (should appear) 


LDOS COMMANDS 


Eight commands are supported by the eprom version of Ldos : 


Directory Load “xxxxxx. Tx" 
Format Save "xxxxxx.Tx" 
Exit Delete "xxxxxx.Tx" 


and drive select commands 


These commands don't use token words like Timex Basic but are 
typed in letter by letter . Only the first 4 letters of a 
command need to be typed . 

eg: Dele "xxx. B1" 
Form 


Synt as 
Load, save,and delete require a file name to follow the 
command. 
The proper syntax for a file name is - 


When data type is array the first 2 characters specify the 
name of the array. eg: save "afname. Ax" will search for an 
array called a$ and save it. The second character has to be 
a "t" specifing a string array or a "8" specifing a.numeric 


array. /\ 


KKK KKK. TK" 


a b NEC RR 
The extension 


The program name Tan be up to The period is has to be 2 
6 characters long. a separator and letters long. 
The whole file name is in is compulsary First letter 
quotes. specifies the 

file type: 

A ~ Array 

B - Basic Frog 


C - code Block 
Last letter can 
be anything 








Entering Commands 


Commands may be entered in immediate mode by entering The Ldos 
monitor using a Print USR call without a line number or comm- 
ands can be executed from running basic programs. 

When a command is to be executed from within a program the 
command is held in a REM statement preceded by the USK call. 

eg: 100 Rand USR 14234 

120 REM save “prog.Bz" 


Auto Run Programs 

When a program is saved from within a running program, it 
will continue from the next line when it is loaded back in. 
A STOF statement before the saveing lines is sometimes wise to 
put in so the program doesn't accidently resave its self. 

eg: 1 REM program 


80 STOP 

90 Rand USR 14336 (use a RAND USK if you don't want 
100 REM save "Test .B1" anything printed on the screen.) 
110 Goto 1 


(type Goto 90 to save program 3 


Formating 

New disks must be formatted by the Format Command before data 
can be saved on them. Formatting initializes the directory and 
writes zero's in the data field on all the tracks. It also 
read's the data back in to check for sumcheck errors (CRC ERR). 

A good disk should not have any CRC errors but sometimes a 
heavily gaussed disk may have to be Formated more than once. 

Use a good quality double sided disk that is soft sectored. 
-If the system will save and load programs on disks that it has 
Formatted but wont read disks from another Larken system this 
means that one or both of the disk drives is not aligned corr- 
ectly (Most computer stores can align disk drives) 


Saving KK KKM. TX" 


BASIC programs are saved from the start of the system 
variables to the end of the variable area. Variables are saved 
with the program . Note- to save a Basic Program „the first 
letter after the períod in the file name must be a "B". 


MACHINE CODE or memory blocks can be saved by poking the start 
address into locations 12204 (lsb) and 1220S(msb) and by poking 
the lenth into locations 12306 (1sb) and 12307 (msb) 
then save then save the file with a "C" after the period in the 
file name. 
eg: to save a block starting at 50000 that’ S500 bytes long 
256*195+80=50000 
Foke 12304,80 
Poke 12205,195 
256*1+244=500 
Poke 12305,244 
Poke 12207,1 z 
then save "xxxxx.Cx" 





Saving Code Continued- 

- Note ,never load or save code over the machine stack area or 
undecoded memory area's in memory . eg:if you only have a 16k 
ram pack dont save memory above 32768 ,as this will cause 
unpredictable results. 


A Basic program for poking these locations could be on disk and 
loaded when ever needed. 
eg: 10 REM Poking program 
15 PRINT "input start address ? "; 
20 INPUT a 
25 Frint a 
30 LET b= INT (a/2506) 
35 LET c=a-(256*b) 
40 Poke 12304,c 
45 Poke 12305,b 
47 PRINT "input lenth? "3 
SO INFUT a 
SS PRINT a 
60 LET B=INT (a/256) 
65 LET cza-(256*b) 
70 Foke 12306,c 
75 Poke 12207,b 


ARRAYZ must be dimentioned in memory before then can be saved 
or loaded , or a "NO FILE" error will result . Also when an 
array is reloaded the predimentioned array in memory must be the 
same size as when it was saved. 
eg : to save the array "a$" 

10 DIM A£(1000) 


100 RAND USR 14336 
2 110 REM save "A$XXXX.AX" (example) 


LOAD "TS SN KK. TX" 


Loading can be done in the Dos monitor or from within programs 


The computer can effectivly run up to a 150K (or ZOOk if 2 drvs) 
program by loading in new programs. 
When code is loaded , it is loaded back into the same place as 


where it was saved from. 

With the disk drive you can usually load code directly into 
free memory "below ramtop" as long as you leave about 100 bytes 
above the code for the stack. But be careful that your basic 
program isn't going to overwrite the code as it is unprotected 
by ramtop. 


DIRECTORY 

The directory displays all the files that are on the disk. A 
total of 52 files per disk be contained. The number of blocks 
used by the file is displayed and at the bottom the number of 
free blocks is printed also. 

When a disk full error occurs or an array can't be found for 
Saving,the file name will appear on the disk but no blocks will 
be used. Just delete this file name. 

The Directory can be printed on the printer by entering the dos 
with a LFRINT USR 14336 command. You wont be able to see what 
you are typing until you press enter. Also you will never get 
the screen full error .EXIT will return you to the Basic as 
normal 





DELETE KK KKK. TK 


The delete command will remove the file name from the directory 


EXIT 
Exit returns you to basic when you are in the monitor. 


Selecting Drives 


When operating a dual drive system,the way you select the drive 
you want to access,is to directly output a value to port 87,by 
poking 12300, port (87) and poking 12201, © (for drivel) or Z 
(for drive 2), then RAND USR 16374 

eg: to set drive 1 -POKE 12300,87 

FOKE 12301,0 


RAND USR 16374 


eg: to set drive 2 -FOKE 12300,87 
FOKE 12301,2 
RAND USR 16374 


- when you first power up the system, drive 1 is automatically 
selected.It will stay selected until you select drive 2. 

- this subroutine at 15374 can be used to output data to any 
port . It is - LD BC (12200) , QUT (c),b - in machine code. 
note- only use odd # ports 


ERRORS 


? - Ldos doesn't recognise the command (first 4 letters) 
SYNTAX ERR A syntax error occurs when 
- a command doesn't have a legal file name 
- the command in a REM statement isn't correct 
NO FILE occurs : 
- on a load move delete or copy if the file isn’t on disk 
— when the dos can't find an array (maybe because it 
wasn't already dimentioned 
PROT ERR 
— occurs when a save delete format or copy 1s performed on a 
disk with a write protect sticker 
CRC ERR 
— Occurs when data cannnot be read from a track after 10 
tries . The number after the error is the track number. 
DISK FULL 
- Occurs when the disk doesn't have enough room on it to hold 
the file .The file name will appear on the disk but no 
blocks will be used. 
- Occurs when more than 52 directory entries are made. 


ADDITIONAL COMMANDS are available on disk Tram LARKEN 
ELECTRONICS .These include Copy,Mave,Badblocks, Backup and alse 
extra BASIC commands such as Free, Clear, scroll (up, down, 
left, right) etc. 

They are available in 3 memory areas „A REM statement (16514), 
lék ramtop version (28000 to 32000) , and a &4k ramtop version 
for rams that can run machine code up at éOO000. 

Please specify the required version. 
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ENTERING LDOS from MACHINE CODE 

When the dos 1s entered it checks to see if was called from a 
running program or from immediate mode by peeking basic 
variable (16291) . If it see's a 255 then this means that the 
program wasnt running and that it should print "LDOS" and enter 
the keyboard input routine. If it is other that 255 then it gets 
the command from the next REM statement in the program. Either 
way the command is transfered to the command buffer at "Cline". 
^ routine called "sort" then checks syntax and jumps to the 
right routine. 

The way to enter the dos from machine code would be to transfer 
your command (eg: Load "uzxxx.XX") to "cline" and the jump or 
Call sort.(Its not necessary to poke 16391 ) 

Directory Format,copy and Delete always return to the keyboard 
routine when finished and have to be exited. 

Load and Save return by jumping to 0207 (hex) 


DOS Utility Subroutines 
Listed following are machine code subroutines that are in the 
dos that may be useful to programers to make custom files 
stimulate sequential files,repair damaged directorys or reenter 
deleted files.When entering savebf,loadbf,settrk or nextrk, you 
must be in fast mode. The outport subroutine calls fast mode 
itself. ` 

If your directory got damaged, maybe caused by the disk being 
glitched when you powerup etc, you can reconstruct it by: 

- format a new disk and then put all the names of the files 
(that you want to salvage off the damaged disk) on the new disk 
by saveing the programs to disk. (it doesn't matter if there is 
no program in memory to save , you just want to get the name put 
into the directory) ` 
- Enter the dos, do a directory and exit. 

- place your damaged disk into the drive and then do a FAST, 
turn the drive motor on with the outport  subroutine,wait 1 
second and then call Savebuffer. 

- this will save the buffer (with the new directory in it ) on 
to the old disk. 

- Then you must search through all the tracks (with the program 
"dump.B1" ) to find what tracks your programs are on. Then the 
tracks must be enteced into the directory name cells (using the 
program "tool.B1") according to the directory diagram in the 
back if this manual. 

- the tracks dont have to be entered into the track map if you 
don't plan on doing any saves or deletes on the disk . 

- you should then copy the programs off the disk and reformat 
the disk. 





Machine Code Subroutines 


HEX DECIMAL 

Loadbuf fer 3802 14546 

Savebuffer SAOD 14861 

Settrk S9RBA 14778 

Nexttrk IJAB 14763 

Output SFF 16274 

Sort S88F 14479 

curtrk 12289 

Cline 12306 

buffer 12352 

data 12376 

workspc -start of dos work space (12288) 

buffer  —-area of memory that is saved to or loaded from the disk 
the first 24 bytes of buffer are used for sumcheck,file 
name, track # and data address and lenth. 

data - total lenth ,1960 bytes. Directory if trk O is loaded. 

loadbf -subroutine to load the track the head is at,into 
the buffer. 

savebf  -subroutine to save buffer to current track. Before 
using this,turn the motor on for 1 second . 

settrk -subroutine to set the head on the track# in the 
variable (curtrk).It first returns to track O 

nextrk -subroutine to set'head on next side or track depending 
if curtrk is odd or even.Increments curtrk. 

Curtrk -trk # variable -range 0 to 79 

sort -the entry point to the command interpreter.Command 
should be at cline. 

cline -command line. For direct entry into dos from assembly 
language, transfer your command into cline then call 
sort 

outport -general purpose port output routine.It can be used to 


select drives 1 or 2, turn the motor on ,or output data 
to any odd# port. Poke 12z00,port& Poke 12301,data 
then call output at 16374. (Rand usr 16374) 
-Port 69 (dec) controls the disk drive. 


Bit O - Stepper pulse 

Bit 1 - Stepper direction 
Bit 2 ce Side select 

Bit 3 - Motor on 

Bit 4 = Write enable 





m men o. 


f 


















Ig |workspe sht => Stortof Dir Address in Memory | 
d Name Ceil tl Referenced (eve Works | 
S <—~ Wort F 
w c Start 
e rd aile M 
Y ty S Voriables 
ane x | fist locat aed We 
-Nat Saved Qffe 1 ten ^ ork Space 
Ondisk S heim Ped Saved 
Next * 
Lë Iag4 dis P des Reserved 
ae L ame / , From this area- On 1S 
D || exome le on e 
Cé TS Mome Cell g E el RC Ze S 
TU GE B los COJE Track oddrecs-O 
m - 
lég| x nd t Ses [353] ed df Nome Reserved Area 
i64 | Q | Name of 142. 12q Tatu for Sum check 
m Bearom {30 Sera 
aU. jaa fla rant Beene 
TT ot «(ile A esetved 
; rods miker- Directory i 
Track d 
8 ieee Ran discs WY ae 
l for 94 tracks 13 e SE b 
Start add [zzz] Stod ! 4mpj. EBI So 
of Data i 203| R35] Nome Diu a 3 they Have Bit 7 
704 254 ~ ASH meos, RK Set Cree addins ) 
evan of k pue or Not 5 
s: €xan f 
| ofa & Zreck Map 
Reserucd ried 7 Greg Theseare 
Xoc Sum ti Bytes from O-7G 
Check erd SES e with Bit 7set 
($43 ! Eich en mackec Kl de tet. is 
- Shows No tracks i £. Ly a {rie 
Used By this Gell 
yer 1 
1960 ; Stort of Name 
Bytes d Cell e? 
of Data $3 
More 
Mime 
Cells : 
A047 [389] - - End of Dir "79 ENG of track 
Marker map 





Â Loi 








LDOS File Format 


(dos keeps a directory on all files and a track map on track 0. 
The track map is a list of numbers, © to 79 representing tracks 
oO to 79. The track map entry will have bit 7 set if the track is 
used by a file . Since track 0 is reserved for the directory,the 
track map always starts with a 128 (0 with bit 7 set).The track 
map is located at the begining of the directory track. Following 
the track map are 52 directory file cells. Each cell can contain 
a file name and the track numbers of up to 24 tracks (these 
tracks will have bit 7 set). Each track can hold up to 1960 
bytes of data ,so the maximum file size is 24 * 1960. Markers 
are used within the cells. A 255 marks the start of each cell. 

A 254 may follow the 255 if the cell has not been used or the 
file was deleted . A 253 is placed 10 bytes after the 255 and it 
marks the end of the file name and begining of the tracks used. 
Following the 253 are the tracks used by the file and then a 
floating 249 follows that. This is repeated 51 more times.A 250 
marks the end of the directory. (Dont use any characters in 

file names that are the same as these markers). 

Tracks 1 to 79 hold the data. The first 24 bytes is the header 
that contains the track number, the file name ,the start address 
of where the file goes, the lenth and the sum check. Then there 
is the 19760 bytes of data. 
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Connect directly to 2X-81 bus 
try not to have any thing connected 
between it and the computer. 





50 pin connector 
Centered on 46 pin 


Connect periferals on 
this connector 


-To remove cable pry off 
from sides don't pull on oable. 


SSE-T —UJF- 

~ After connecting the power supply up (rä orange ) (GND black) 
to the board and connecting the disk drive power and signal 
cables,the sys should power up and you should get the cursor. 
The disk drive should not come on yet. It is normal for some 
disk drives to activate to motor for a few seconds when a disk 
is inserted . This feature is for centering the disk. If the 
motor and LED come on continuosly when the power is on,the drive 
ribbon cable may be on wcong .This cannot cause any damage. 

Type "Print usr 14336" and you should get LDOS and an "sn, You 
can try a DIRECTORY command to see if the motor is going to come 
on. If it does you are in luck. If it doesn't your disk drive 
jumpers are probably set wrong.. 

They should be set for drive 1,and motor on with drive select. 
(there should be jumpers or switches on the drive labled, MS and 
MM .The MS should be jumpered and the MM should be not jumpered) 
The motor and LED on the drive should only come on when the dos 
is accessing the drive. 

An other way to turn the motor on for testing only is a direct 
port call using a subroutine on the dos eprom.This subroutine 
can output any value to any port. You have to (poke 12300,port) 
and (poke 12301,value) then Print USR 16374. Note -this subrout- 
ine is only for testing. Never use even number port addresses. 
-To turn motor on, Foke 12200,6569; Foke 12301,8 ;Print USR 16274 
-To turn motor off,Poke 12300,69; Poke 12301,0 ;Print USR 16374, 

If all is ok then format a disk. It should format with no CRC 
Errors .If it has CRC errors only on the inner most tracks you 
may need to adjust the blue trimmer resister on the controller 
board .NOTE - remember where the adjustment was when you started 
sit shouldn't have to be turned more than 1 turn in either 
direction .Try turning it 3/4 turn in one direction then 
formating a disk .If it gets worse return it to its initial 
point the turn it 2/4 turn in the other direction. After this is 
set it shouldnt have to be touched again. 

-If you are using a single drive on a double controller it is 
advisible to have the drive jumpers selected for drive 1 and 2. 
This way if when powered up the drive 2 gets accidently selected 
the computer will not hang up when you try to access the disk. 
(this is because it is waiting for drive 2 to respond), 

- If you are using a 64K rampack, make sure the 8K to 16K area 
is switched out so it doesn't conflict with the dos. 
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Controller +o Disk drive 
Coble Placement 
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